/* 
 * Enterprise Library Extensions - DI + ORM.
 * Copyright (C) 2006
 *
 * GNU General Public License
 *
 * This program is free software; you can redistribute 
 * it and/or modify it under the terms of the GNU General Public License 
 * as published by the Free Software Foundation; either version 2 of the 
 * License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful, but 
 * WITHOUT ANY WARRANTY; without even the implied warranty of 
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
 * See the GNU General Public License for more details.
 */
using System;
using System.Reflection;

namespace ELE.EnterpriseLibrary.Common.Configuration.Design
{
  /// <summary>
  /// This interface allows the definition of an object that makes a loose reference to an assembly.
  /// <para>It is used for example by the <see cref="AssemblyTypeSelectorEditor"/> to obtain an assembly 
  /// that facilitates its functionality.</para>
  /// </summary>
  public interface IAssemblyReferencingObject
  {
    /// <summary>
    /// Return the referenced assembly
    /// </summary>
    /// <returns>the referenced assembly</returns>
    Assembly GetReferencedAssembly();
    /// <summary>
    /// Get the name of the referenced assembly.
    /// <para>Usually implemented by doing:</para>
    /// <code>
    ///  return this.GetReferencedAssembly().FullName;
    /// </code>
    /// </summary>
    /// <returns>The name of the refenced assembly</returns>
    string GetReferencedAssemblyName();
  }
}
